home *** CD-ROM | disk | FTP | other *** search
/ Dr. Windows 3 / dr win3.zip / dr win3 / WINPROGS / VCSLID.ZIP / README.TXT < prev    next >
Text File  |  1993-09-03  |  10KB  |  254 lines
  1. ----------------------------------------------------------------
  2.  
  3.                         Slider Control  
  4.  
  5.               Copyright 1993 Northeast Data Corp.
  6.  
  7.                      All Rights Reserved
  8.  
  9.  
  10.  
  11.       This is the DEMO version of the control. It has the 
  12.       same characteristics as the commercial version, except
  13.       for a notice that appears each time the control is 
  14.       loaded.
  15.  
  16.  
  17. ----------------------------------------------------------------
  18.  
  19.  
  20.    Release 1.0
  21.  
  22.    August 1993
  23.  
  24.  
  25. This document describes the Slider Custom Control. 
  26.  
  27.  
  28.                CONTENTS
  29.  
  30. 1. Product Description
  31. 2. Legal Information
  32. 3. Installation
  33. 4. Usage
  34. 5. Support
  35.  
  36.  
  37. ----------------------------------------------------------------
  38.  
  39. 1. Product Description
  40.  
  41. The Slider Control is a Microsoft Windows DLL designed and 
  42. implemented in compliance with Microsoft standards for
  43. interfacing with applications and the SDK Dialog Editor.
  44.  
  45. The Slider Control is intended for use by application programmers
  46. who are using the Microsoft SDK for Windows version 3.1. The control
  47. appears to the end user as a slider similar to those used on audio/video
  48. equipment such as stereos, tuners, and amplifiers.
  49.  
  50. To the application programmer, the interface to the slider is similar
  51. to the one for the MS Windows standard scroll bar. The programmer can
  52. set a range of values that will be fed back to the application as the
  53. end user adjusts the position of the slider on its scale.
  54.  
  55.  
  56. Being integrated with the MS Windows SDK Dialog Editor, the programmer
  57. can add the Slider Control to the Dialog Editor. This allows use of the
  58. control in dialog boxes. The programmer can also use the control in an
  59. application window by creating a window whose class is "slider".
  60.  
  61. Use of the Slider Control in a finished application requires the
  62. Slider Control DLL (slider.dll) to be installed with the application.
  63. This is true of all custom controls written for MS Windows.
  64.  
  65. There are style settings available that allow the programmer to control
  66. the behavior and appearance of the Slider Control. The slider can appear
  67. in a horizontal or vertical orientation. A horizontal slider can have top
  68. "tick marks", bottom tick marks, no tick marks, or tick marks on both the
  69. bottom and top. This is also true for vertical sliders, where tick marks
  70. are left and right rather than top and bottom.
  71.  
  72. The range of the slider can be set to any range with low and high values
  73. varying from 0 to 32767.
  74.  
  75. All communication between the Slider Control and the application is 
  76. performed using the standard Windows message mechanism for controls. 
  77. Design of the Slider Control message mechanism allows the application to
  78. continuously monitor the setting of the control.
  79.  
  80. A Visual Basic version of the Slider Control is available separately in 
  81. the form of a standard "VBX" control. It allows use of the control from 
  82. the Visual Basic and Visual C++ environments.
  83.  
  84.  
  85. -------------------------------------------------------------------
  86.  
  87. 2. Legal Information
  88.  
  89. The purchaser of the Slider Control is allowed to use it and
  90. distribute it in applications without paying any royalty, and without
  91. printing or displaying a copyright notice for the control. This only
  92. includes distribution of the Slider Control DLL. It does not include
  93. distribution of the header file, import library, or documentation that
  94. comes with the Slider Control. 
  95.  
  96. The purchaser of the Slider Control may distribute the control DLL with
  97. applications that are networked (multiple users accessing the DLL from
  98. a file server) without paying any license fees to Northeast Data Corp.
  99.  
  100. The development files for using the Slider Control (this excludes the
  101. DLL) may only be used by the purchaser of the control. The purchaser
  102. may install the development files on his/her own machine for development
  103. purposes. These files may not be made available to any other person in
  104. any way.
  105.  
  106. For use of the Slider Control in any other fashion, the purchaser should
  107. contact Northeast Data Corp. to make special arrangements. 
  108.  
  109. All information regarding purchasing the control can be found during
  110. the initial loading of the DLL.
  111.  
  112.  
  113. -------------------------------------------------------------------
  114.  
  115. 3. Installation
  116.  
  117. Create a "slider" directory on your hard disk and copy all files from
  118. the distribution disk to the directory. Make sure you specify the /s
  119. option in order to copy any subdirectories. Included with the software
  120. is a subdirectory containing a Microsoft Windows foundation class for
  121. the slider as well as a test program for using it.
  122.  
  123. You may want to copy the slider.dll file to your Windows directory. 
  124. This eliminates the need to specify the installation directory as the
  125. working directory when you run the test application or your own
  126. application. You may also want to copy the .lib file to your LIB
  127. directory and the header files (at least slider.h) to your INCLUDE
  128. directory.
  129.  
  130. -------------------------------------------------------------------
  131.  
  132. 4. Usage
  133.  
  134. The slider.dll has to be loaded before you can create "slider" class
  135. windows. Loading the DLL causes the slider to be registered as a global
  136. class. This is necessary in order for the application to be able to
  137. create slider windows. There are two ways to load the DLL. You can
  138. either load it explicitly by calling the MS Windows LoadLibrary API
  139. function, or load it implicitly as in the slidetst demo application.
  140.  
  141.  
  142. If you choose to load the slider implicitly, you MUST call the 
  143. "registerSlider" function. Although this function doesn't do anything
  144. inside the DLL, it causes the linker to generate code that loads the
  145. DLL automatically when your applications starts.
  146.  
  147. Create slider windows by calling the MS Windows CreateWindow function,
  148. or by putting slider controls into a dialog box using the Dialog Editor.
  149. Look at the slidetst.c file for an example of creating the windows from
  150. the application.
  151.  
  152. To use the slider control in dialog boxes, use the SDK Dialog Editor
  153. for Windows V3.1. Install the slider.dll as a custom control. Two sliders
  154. will show up in the custom control dialog box - a vertical slider and a
  155. horizontal slider.
  156.  
  157. There is a directory named MSFC directly below the directory you are
  158. reading this file from (only if you used the -d option to unzip) that 
  159. contains a C++ class based on this control that works with MSVC as well
  160. as a test application for that class.
  161.  
  162. STYLES
  163. ------
  164.  
  165. These are the window styles that can be assigned:
  166.  
  167.    SCS_VERTICAL      - Creates a vertical slider
  168.    SCS_HORIZONTAL    - Creates a horizontal slider
  169.    SCS_TEXTHASRANGE  - If specified, you can assign the initial slider
  170.                        range and position in the text for the control.
  171.                        For example, setting the window text to 1,100,50
  172.                        will create a slider with a range of 1 to 100 and
  173.                        an initial setting of 50. Valid ranges are 0 to
  174.                        32767. If you do not specify this style, you must
  175.                        set these values yourself using the SCM_SETRANGE
  176.                        and SCM_SETPOS messages.
  177.    SCS_INVERTRANGE   - Causes the slider range to be reversed. Horizontal
  178.                        sliders normally have the low end of the range on
  179.                        the left and the high range toward the right. 
  180.                        Vertical sliders have the low end at the bottom and
  181.                        the high end at the top. Specifying this style
  182.                        reverses this order.
  183.    SCS_LEFTTICKS     - Displays tick marks to the left of a vertical slider.
  184.    SCS_RIGHTTICKS    - Displays tick marks to the right of a vertical slider.
  185.    SCS_TOPTICKS      - Displays tick marks along the top of a horizontal 
  186.                        slider.
  187.    SCS_BOTTOMTICKS   - Displays tick marks along the bottom of a horizontal
  188.                        slider.
  189.    SCS_TABSTOP       - The control can be activated by tabbing to it with
  190.                        the TAB key. Like other controls, this is only
  191.                        operatio